home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / gfx / conv / Wasp202b.lha / wasp / doc / wasp.doc < prev    next >
Text File  |  1992-03-21  |  3KB  |  84 lines
  1. Program: Wasp 2.02 beta
  2. Copyright Steven Reiz 1991, 1992, see the COPYING file for more info.
  3. Purpose: Converts pictures from GIF and IFF format to IFF format.
  4. Usage:   wasp [options] [operations] [parameters] infile|- [outfile|-]
  5.  
  6. Input formats supported:
  7. - GIF (87a)
  8. - IFF hires, lores, HAM, EHB, sliced hires, lores, and HAM, dynamic hires,
  9.   lores and HAM, 24-bits IFF.
  10. - SRGR, a private format, basically uncompressed 12-bits RGB.
  11. - Sun rasterfile, monochrome only
  12. - PPM, P5 (binary 8-bits greyscale) and P6 (binary 24-bits RGB) only.
  13. - HL2, the temporary file format produced by the Hamlab input filters
  14. - MTV, produced by a.o. the Rayshade raytracer
  15.  
  16. Output formats supported:
  17. - IFF hires, lores, HAM, EHB, sliced hires, lores, and HAM, dynamic hires,
  18.   lores and HAM, 24-bits IFF.
  19. - SRGR
  20. - PPM, P6 (binary 24-bits RGB) only, the four least significant bits
  21.   of the r, g, and b component of the pixels are zero.
  22.  
  23. Main features:
  24. - SPEED! This program has been developed on an unaccelerated A500, on which
  25.   all of the other GIF -> IFF conversion programs ran way too slow.
  26.   Wasp is three times faster than supercon, seven times faster than
  27.   gifmachine, and even faster than TAD, a commercial program!
  28. - Good output quality, generally better than TAD, and much better than most
  29.   other programs.
  30. - Many IFF output formats are supported, including HAM, sliced HAM, dynamic
  31.   HAM and dynamic hires.
  32.  
  33. Operation
  34.  
  35. Wasp reads the input file and tries to recognize it. If this succeeds
  36. it prints some information about the format of the file and the size
  37. of the picture. If the outfile argument was omitted, wasp stops here.
  38. Otherwise it reads the input file, and converts it to the internal
  39. format; 12-bits RGB. It optionally applies operations such as clipping
  40. and scaling to the internal picture, and then converts it to the requested
  41. output format.
  42.  
  43. Reading from stdin/writing to stdout
  44.  
  45. Wasp will try to read the input image from stdin and/or write the
  46. output image to stdout if you specify the filename(s) as '-'.
  47. This only works for images that don't have to be seeked, meaning
  48. nearly all inputfiles, and lots of outputfiles. Some image types
  49. which can always be read from stdin and written to stdout are ppm
  50. and srgr. Problems can occur when reading iff files without a camg
  51. chunk, or when writing iff files.
  52.  
  53. Using the Hamlab input filters with Wasp
  54.  
  55. Hamlab and the demo version of hamlab come with a number of input
  56. filters, readers for the gif, mtv, pnm, qrt, ras, spec and tiff
  57. formats. Some examples of using these filters with Wasp:
  58.  
  59. When using the SKsh shell, which supports pipes:
  60. ( qrt2hl <somepic.qrt ) | wasp -sliced -lace -ham - somepic.sham
  61.  
  62. Using the AmigaDOS shell:
  63. tiff2hl <foobar.tiff >foobar.hl
  64. wasp -dyn -hires -enlarge 640 200 foobar.hl foobar.dynhi
  65.  
  66. Comments
  67.  
  68. Comments, suggestions, bug reports, and dollar bills (uuencoded, of course)
  69. can be sent to sreiz@cs.vu.nl, I would appreciate some feedback, let me
  70. know what you think about wasp!
  71.  
  72. Options
  73.  
  74. If wasp is invoked without options it prints an extensive list of all
  75. the options it understands. When in doubt: Use the Force, Read the Source.
  76.  
  77. Example
  78.  
  79. ``wasp -sliced l.gif l.sham'' converts the GIF file l.gif to sliced HAM.
  80.  
  81. Have fun!
  82.  
  83.     Steven
  84.